home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Best of Shareware
/
Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso
/
mac
/
DOS
/
UTILITY
/
WIZ26
/
CALL_WIZ.DOC
< prev
next >
Wrap
Text File
|
1991-09-18
|
2KB
|
62 lines
CALL_WIZ.DOC
------------
by Ray Van Tassle
1020 Fox Run Lane
Algonquin, Ill, 60102
(708)-658-4941
September, 1991
WIZ can be used by another program to do file finding. This
could be particularly useful for a disk viewer, such as
XTREE, QFILER, and others.
In this mode, instead of typing out the filenames, WIZ will
copy the strings to a memory buffer specified by (and in) the
calling program. In this mode, WIZ won't type out anything
(except error messages), so it will be invisible to the user.
WIZ may be called either directly (via the DOS EXEC function),
or by spawning via COMMAND.COM. An example program showing
how to call WIZ is included in this distribution.
The calling program gives WIZ it's PSP (program segment
prefix) with the "-z" switch. WIZ makes some checks to verify
that this is a valid PSP. Then it looks in the memory block
for the signature of the inter-task-communication (ITC) block.
The ITC must be in the first 64KB of the program (following the
PSP).
The calling program can make the ITC as large as it wants.
It specifies the size as the 1st word of the ITC. Upon return
from WIZ, the 1st word has the number of strings that WIZ
put into the ITC. The next byte contains a character to tell
the caller if WIZ was able to store all the strings that it
wanted to in the ITC. (Period (.) is so, plus (+) if not--plus
meaning "there was more, but I couldn't fit it all".)
Starting with the 4th byte, WIZ puts the strings as ASCIZ--the
same way that environment strings are stored. The last string
is terminated with two NULL characters.
All the other switches to WIZ still work, and perform their
usual function. You probably would not want to give either the
"-g" option, or "-cdel*". To get just the filenames (including
disk and path), you would need to give "-p".
========================================
Permission is hereby granted for anybody to include a call to
WIZ from another program, and to distribute WIZ along with
their program, provided that the complete WIZ distribution
package is included (executables, example source code, and
documentation).